docs: Document more accessible roles
authorMatthias Clasen <mclasen@redhat.com>
Wed, 21 Oct 2020 03:19:30 +0000 (23:19 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Wed, 21 Oct 2020 03:19:30 +0000 (23:19 -0400)
Document that GtkText is skipped in accessibility.

gtk/gtktext.c

index 59f68d04f7117caac83d3f7b3ce1e180ce7227b2..7f3d064a941e6928d08ec76ab579b8ee898477c5 100644 (file)
  * CSS nodes with name cursor-handle. They get the .top or .bottom style class
  * depending on where they are shown in relation to the selection. If there is
  * just a single handle for the text cursor, it gets the style class .insertion-cursor.
+ *
+ * # Accessibility
+ *
+ * GtkText uses the #GTK_ACCESSIBLE_ROLE_NONE role, which causes it to be skipped
+ * for accessibility. This is because GtkText is expected to be used as a delegate
+ * for a #GtkEditable implementation that will be represented to accessibility.
  */
 
 #define NAT_ENTRY_WIDTH  150